home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / rbbs_pc / msgtos20.zip / MSGSWI.DOC < prev    next >
Text File  |  1992-02-11  |  80KB  |  2,245 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.                           MSGTOSS Version 2.0
  16.  
  17.           High-Performance FidoNet Mail Processor for RBBS-PC
  18.  
  19.         Copyright(c) 1989-92, Mike Zakharoff & Warren Muldrow
  20.  
  21.                Mike  : FidoNet 1:138/154 Rbbsnet 8:918/10
  22.                Warren: FidoNet 1:3617/1  Rbbsnet 8:928/1
  23.  
  24.  
  25.                           ALL RIGHTS RESERVED
  26.  
  27.  
  28.                     R E F E R E N C E    M A N U A L
  29.  
  30.                                   for
  31.  
  32.                       MSGTOSS Command Line Switches
  33.  
  34.  
  35.                          Written by Mike Zakharoff
  36.  
  37.  
  38. The  MSGTOSS supports a multitude of command line switches to support vari-
  39. ous aspects of tossing,  scanning, and maintenance functions.   MSGTOSS has
  40. nine  major command line switches each of which calls a special function of
  41. MSGTOSS.  For instance, to execute the tossing mode of MSGTOSS, the command
  42. line  /TOSS  initiates the session.   Each major switch and its  associated
  43. sub-switches are discussed in detail.
  44.  
  45. MSGTOSS supports 'Meta-Commands' where an unlimited number of command lines
  46. can be defined and reduced to a single command entry.  
  47.  
  48.  
  49.                                  DISCLAIMER 
  50.                                  ---------- 
  51.  
  52. The  authors make no claims or warranties with respect  to the contents  or
  53. accuracy  of this publication,  or the product it describes,  including any
  54. warranties  of fitness or merchantability for a  particular purpose.    Any
  55. stated   or  expressed warranties  are  in  lieu   of  all  obligations  or
  56. liability for any damages,  whether special,   indirect,  or consequential,
  57. arising   out  of or  in  connection  with the  use of this publication  or
  58. the product it describes.   Furthermore, the  right is reserved to make any
  59. changes  to this  publication  without   obligation  to  notify  any person
  60. of such changes. 
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.                       MSGTOSS 2.0 Command Line Switches
  69.  
  70.  
  71.                                L I C E N S E
  72.                                -------------
  73.  
  74. MSGTOSS  is   not a  Public Domain  program and is not  free.   MSGTOSS  is
  75. copyright(c)  1989,1990,1991,1992  by  Mike Zakharoff and  Warren  Muldrow.
  76. Non-registered users of  this  program are  granted a  two week license  to
  77. evaluate   the program suitability for their requirements.   Any usage   of
  78. Msgtoss  beyond evaluation time period requires registration.   Use of non-
  79. registered  copies of Msgtoss beyond the original evaluation  period is not
  80. wished. You are free to distribute the PUBLICLY AVAILABLE shareware version
  81. of MSGTOSS.
  82.  
  83. MSGTOSS is SHAREWARE.  MSGTOSS was not an easy project,  as  it took 1000's
  84. of hours to develop and test.  The author has written other  RBBS utilities
  85. such as MSGRENUM, MAILWAIT, MSGECHO, FIXMSG, all of which  were released as
  86. freeware;   none  of  which  compares  to  the complexity  of MSGTOSS.  Fu-
  87. ture  releases  of MSGTOSS will depend upon  how much support   the  author
  88. receives. Therefore the author is asking $25.00 for its use to:
  89.  
  90.                                MIKE ZAKHAROFF
  91.                              18004 22ND ST CT E
  92.                               SUMNER, WA 98390
  93.  
  94. Keep  in mind that the authors could have easily crippled MSGTOSS with  all
  95. sorts  of schemes,  including disabling the multi-tasking/network  support,
  96. requiring a password,  annoying "not-registered" lines appended to the tear
  97. line,  beg screens, long delays,  and other things to pester you to support
  98. the authors.  If I were to figure out the amount of hours it took to devel-
  99. op and test this program, it would easily run into 10,000 hours of personal
  100. time  that really can't be assigned any value.   This was a service to  the
  101. RBBS-PC community, and its development will set the stage for RBBS-PC's fu-
  102. ture in the Fidonet comminity.  Cards and letters always welcome!
  103.  
  104. Registered  users will receive a personal registration code (See REGCODE in
  105. MSGCFG.DOC),  and  as much personal support as   possible.   Non-supporters
  106. will basically be doomed to slither in their own guilt for all eternity. 
  107.  
  108.  
  109.                                  WARRANTIES
  110.                                  ----------
  111.  
  112. MSGTOSS  is guaranteed only to occupy space on your hard drive.   Therefore
  113. the  use  of  MSGTOSS  is  solely at your own risk!  MSGTOSS had been  beta
  114. tested  extensively  to  eliminate bugs, however due to the limitless  pos-
  115. sibilities   of   system  configurations,  no warranty is  possible.  Also,
  116. there are no guarantees that the author will upgrade MSGTOSS.
  117.  
  118.  
  119.                                  TRADEMARKS
  120.                                  ----------
  121.  
  122. The following products are mentioned in this document:
  123.  
  124. Desqview,Makearc,Ommm,Qmail & Rbbs-pc
  125.  
  126.  
  127.  
  128.                                    Page - 2
  129.  
  130.  
  131.  
  132.  
  133.  
  134.                       MSGTOSS 2.0 Command Line Switches
  135.  
  136.  
  137.                            TABLE OF CONTENTS
  138.                            -----------------
  139.                                                                Page
  140.  
  141.       Major command line switches ............................  6
  142.  
  143.       Command Line Switches  - COMMON ........................  7
  144.          COMMON SWITCH MATRIX ................................  7
  145.          /CFG:xxx ............................................  7
  146.          /BBS:xxx ............................................  7
  147.          /LOCK ...............................................  8
  148.          /FIX ................................................  8
  149.          /FIXC ...............................................  8
  150.          /WDIR ...............................................  8
  151.          /AREA:xxx,xxx,xxx ...................................  9
  152.          /AREAF:File.Ext .....................................  9
  153.          /DDA ................................................ 10
  154.          /COUNT .............................................. 10
  155.  
  156.       /TOSS - Toss RBBS, FIDO & NETMAIL messages ............. 11
  157.          /TOSS SWITCHES (BASIC) .............................. 11
  158.             /TOSS ............................................ 11
  159.             /PREP ............................................ 11
  160.             /PREX ............................................ 11
  161.             /TUNK ............................................ 12
  162.             /TCAP ............................................ 12
  163.             /NSTOP ........................................... 12
  164.             /LOCK ............................... (COMMON) ... 12,8
  165.             /FIX ................................ (COMMON) ... 12,8
  166.             /FIXC ............................... (COMMON) ... 13,8
  167.             /WDIR ............................... (COMMON) ... 13,8
  168.             /DDA ................................ (COMMON) ... 13,10
  169.  
  170.          /TOSS SWITCHES (ADVANCED) ........................... 13
  171.             /FEED ............................................ 13
  172.             /FMAX:xxx ........................................ 13
  173.             /KNET ............................................ 14
  174.             /KUNK ............................................ 14
  175.             /KRTE ............................................ 14
  176.             /PKTS:xx ......................................... 14
  177.             /DLOG ............................................ 14
  178.             /DKP ............................................. 14
  179.             /OPUS ............................................ 15
  180.             /MUSER:xx ........................................ 15
  181.             /CFG:File.Ext ....................... (COMMON) ... 16,7
  182.             /BBS:File.Ext ....................... (COMMON) ... 16,7
  183.             /AREA:xxx,xxx ....................... (COMMON) ... 16,9
  184.             /AREAF:File.Ext ..................... (COMMON) ... 16,9
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.                                    Page - 3
  195.  
  196.  
  197.  
  198.  
  199.  
  200.                       MSGTOSS 2.0 Command Line Switches
  201.  
  202.  
  203.                            TABLE OF CONTENTS (continued)
  204.                            -----------------
  205.                                                                Page
  206.  
  207.       /SCAN - Scan (export) new locally entered mail ......... 17
  208.          MIRROR SCANNING...................................... 17
  209.          /SCAN SWITCHES (BASIC) .............................. 17
  210.             /SCAN ............................................ 17
  211.             /RBBS ............................................ 18
  212.             /FIDO ............................................ 18
  213.             /LOCK ............................... (COMMON) ... 18,8
  214.             /FIX ................................ (COMMON) ... 18,8
  215.             /FIXC ............................... (COMMON) ... 18,8
  216.             /DDA ................................ (COMMON) ... 18,10
  217.  
  218.          /SCAN SWITCHES (ADVANCED) ........................... 18
  219.             /RSCAN:zone:net/node ............................. 18
  220.             /HWM ............................................. 19
  221.             /CFG:File.Ext ....................... (COMMON) ... 19,7
  222.             /BBS:File.Ext ....................... (COMMON) ... 19,7
  223.             /WDIR ............................... (COMMON) ... 19,8
  224.             /AREAF:File.Ext ..................... (COMMON) ... 19,9
  225.             /AREA:xxx,xxx ....................... (COMMON) ... 19,9
  226.  
  227.       /SIZE - Chop message bases to preset SIZE .............. 20
  228.          /SIZE ............................................... 20
  229.          /SIZE-UP ............................................ 21
  230.          /CFG:File.Ext .......................... (COMMON) ... 21,7
  231.          /BBS:File.Ext .......................... (COMMON) ... 21,7
  232.          /LOCK .................................. (COMMON) ... 21,8
  233.          /FIX ................................... (COMMON) ... 21,8
  234.          /FIXC .................................. (COMMON) ... 21,8
  235.          /WDIR .................................. (COMMON) ... 21,8
  236.  
  237.       /MWRST - Reset users Mailwaiting Bit (all msgs) ........ 22
  238.          /MWRST .............................................. 22
  239.          /CFG:File.Ext .......................... (COMMON) ... 22,7
  240.          /BBS:File.Ext .......................... (COMMON) ... 22,7
  241.          /LOCK .................................. (COMMON) ... 22,8
  242.          /FIX ................................... (COMMON) ... 22,8
  243.          /FIXC .................................. (COMMON) ... 22,8
  244.          /WDIR .................................. (COMMON) ... 22,8
  245.  
  246.       /STAT - Report on message base statistics .............. 23
  247.          /STAT ............................................... 24
  248.          /COUNT ................................. (COMMON) ... 24,10
  249.          /CFG:File.Ext .......................... (COMMON) ... 24,7
  250.          /BBS:File.Ext .......................... (COMMON) ... 24,7
  251.          /LOCK .................................. (COMMON) ... 24,8
  252.          /FIX ................................... (COMMON) ... 24,8
  253.          /FIXC .................................. (COMMON) ... 24,8
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.                                    Page - 4
  261.  
  262.  
  263.  
  264.  
  265.  
  266.                       MSGTOSS 2.0 Command Line Switches
  267.  
  268.  
  269.                            TABLE OF CONTENTS (continued)
  270.                            -----------------
  271.                                                                Page
  272.  
  273.       /TEST - Test MsgToss Setup Configuration ............... 25
  274.          /TEST ............................................... 25
  275.          /COUNT ................................. (COMMON) ... 26,10
  276.          /CFG:File.Ext .......................... (COMMON) ... 26,7
  277.          /BBS:File.Ext .......................... (COMMON) ... 26,7
  278.          /LOCK .................................. (COMMON) ... 26,8
  279.          /FIX ................................... (COMMON) ... 26,8
  280.          /FIXC .................................. (COMMON) ... 26,8
  281.  
  282.       /WAIT - Wait for users, create MSGWAIT.BAT file ........ 27
  283.          /WAIT ............................................... 27
  284.          /CFG:File.Ext .......................... (COMMON) ... 27,7
  285.          /BBS:File.Ext .......................... (COMMON) ... 27,7
  286.          /LOCK .................................. (COMMON) ... 27,8
  287.  
  288.       /GLOB:xxx - Globally execute xxx for all msg bases ..... 28
  289.          /GLOB:xxx ........................................... 28
  290.          /GBAT ............................................... 29
  291.          /CFG:File.Ext .......................... (COMMON) ... 29,7
  292.          /BBS:File.Ext .......................... (COMMON) ... 29,7
  293.          /LOCK .................................. (COMMON) ... 29,8
  294.  
  295.       /NLST - Recompile the node list (MSGTOSS.NOD) .......... 30
  296.          /NLST ............................................... 30
  297.  
  298.       /EID  - Execute MSGEID.EXE - EID Database Maintenance .. 31
  299.          /EID ................................................ 31
  300.             Display MSGTOSS.EID index ........................ 31
  301.             Make MSGTOSS.CFG parameters match ................ 32
  302.             Pack (remove dead space) ......................... 32
  303.             Clear  a particular  AREA ........................ 32
  304.             Clear  all inactive  AREAs ....................... 32
  305.             Clear  all NODE:x    AREAs ....................... 32
  306.             Change all NODE:x to NODE:y ...................... 32
  307.             Display EID data for AREA ........................ 32
  308.             Change MAXAREAS & DUPSIZE ........................ 32
  309.  
  310.       MSGTOSS.CMD Meta-Commands - (no slashes) ............... 33
  311.          MSGTOSS Meta-Commands ............................... 33
  312.          SUMMARY ............................................. 33
  313.  
  314.       MSGTOSS ErrorLevel Semaphore File Codes - Errorlevels .. 34
  315.          ERRORLEVELS ......................................... 34
  316.  
  317.       INDEX (See MSGIDX.DOC).................................. <-
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.                                    Page - 5
  327.  
  328.  
  329.  
  330.  
  331.  
  332.                       MSGTOSS 2.0 Command Line Switches
  333.  
  334.  
  335. Major command line switches
  336. ---------------------------
  337.  
  338. MSGTOSS is a comprehensive mail processor for RBBS systems.   As a con-
  339. sequence,  there  are  currently  41 command  line  switches,  over  46
  340. MSGTOSS.CFG  configuration parameters and 19 MSGTOSS.BBS keywords  that
  341. all  interrelate with one another.   This tremendous number of interre-
  342. lated system configuration items demonstrates the amount of flexibility
  343. built into MSGTOSS.
  344.  
  345. In  addition  to tossing and scanning messages,  it has other  non-mail
  346. utilities built-in.   Because of this, there are TEN MAJOR command line
  347. switches,  which  tell MSGTOSS what major operation is being requested.
  348. When a major command line switch is issued,  any other switches not re-
  349. lated  to the major operation are ignored.   You cannot issue TWO major
  350. command line switches simultaneously.   For purposes of this documenta-
  351. tion, these will be referred to as 'major command line switches'.  Here
  352. are the TEN major command line switches.
  353.  
  354.        1) Toss RBBS, FIDO & NETMAIL messages -------> /TOSS
  355.        2) Scan (export) new locally entered mail ---> /SCAN
  356.        3) SIZE message bases to preset RECS:xxx ----> /SIZE
  357.        4) Reset users Mailwaiting Bit (all msgs) ---> /MWRST
  358.        5) Report on message base statistics --------> /STAT
  359.        6) Test MsgToss Setup Configuration ---------> /TEST
  360.        7) Wait for users, create MSGWAIT.BAT file --> /WAIT
  361.        8) Globally execute xxx for all msg bases ---> /GLOB:xxx
  362.        9) Recompile the node list (MSGTOSS.NOD) ----> /NLST
  363.       10) Execute MSGEID.EXE - EID Database Maint --> /EID
  364.  
  365. NOTE: Executing  MSGTOSS<rtn> at the DOS prompt will produce a  similar
  366.       display.  You can then enter the number of the major command line
  367.       switch,  then all related switches are displayed along with a de-
  368.       scription and purpose.
  369.  
  370.       ------------------------> ATTENTION! <------------------------
  371.  
  372.       Read the above paragraph carefully!  Alot of questions about set-
  373.       ting  up  MSGTOSS  can be answered by  simply  entering  'MSGTOSS
  374.       <rtn>' at the DOS prompt.  MSGTOSS provides a summary of all com-
  375.       mand  line  switches  (associated  with the  major  command  line
  376.       switch) with its built-in help function.
  377.  
  378. ----------------------------------------------------------------------
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.                                    Page - 6
  393.  
  394.  
  395.  
  396.  
  397.  
  398.                       MSGTOSS 2.0 Command Line Switches
  399.  
  400.  
  401. Command Line Switches  - COMMON
  402. -------------------------------
  403.  
  404. MSGTOSS has ten command line switches that are shared between the major
  405. switches.  If a command line switch is shared between two (or more) ma-
  406. jor switches, it is considered a 'common' command line switch.
  407.  
  408. Here  is a summary of the common command line switches,  along with its
  409. associated major switches.
  410.  
  411.  
  412. COMMON SWITCH MATRIX
  413. --------------------
  414.  
  415. Common       Major Switches
  416. ----------   ---------------------------------------------------
  417. /CFG:     -  /TOSS /SCAN /SIZE /MWRST /STAT /TEST /WAIT /GLOB:xx
  418. /BBS:     -  /TOSS /SCAN /SIZE /MWRST /STAT /TEST /WAIT /GLOB:xx
  419. /LOCK     -  /TOSS /SCAN /SIZE /MWRST /STAT /TEST /WAIT /GLOB:xx
  420. /FIX      -  /TOSS /SCAN /SIZE /MWRST /STAT /TEST
  421. /FIXC     -  /TOSS /SCAN /SIZE /MWRST /STAT /TEST
  422. /WDIR     -  /TOSS /SCAN /SIZE /MWRST
  423. /AREA:    -  /TOSS /SCAN
  424. /AREAF:   -  /TOSS /SCAN
  425. /DDA      -  /TOSS /SCAN
  426. /COUNT    -  /STAT /TEST
  427.  
  428.  
  429. Another way of looking at the above matrix, probably more useful:
  430.  
  431. Major       Common Switches
  432. ----------- ------------------------------------------------------
  433. /TOSS     - /CFG: /BBS: /LOCK /FIX /FIXC /WDIR /AREA: /AREAF: /DDA
  434. /SCAN     - /CFG: /BBS: /LOCK /FIX /FIXC /WDIR /AREA: /AREAF: /DDA
  435. /SIZE     - /CFG: /BBS: /LOCK /FIX /FIXC /WDIR
  436. /MWRST    - /CFG: /BBS: /LOCK /FIX /FIXC /WDIR
  437. /STAT     - /CFG: /BBS: /LOCK /FIX /FIXC /COUNT
  438. /TEST     - /CFG: /BBS: /LOCK /FIX /FIXC /COUNT
  439. /WAIT     - /CFG: /BBS: /LOCK
  440. /GLOB:xx  - /CFG: /BBS: /LOCK
  441.  
  442.  
  443.     /CFG:xxx
  444.     -------
  445.     Use  alternate  MSGTOSS.CFG  file.   This is useful for  those  who
  446.     need  to  separate various *.BBS files and who use a  multitude  of
  447.     mail processing utilities.  In other words, if you use this switch,
  448.     you are probably a HUB of some sort.
  449.  
  450.     Used with: /TOSS /SCAN /SIZE /MWRST /STAT /TEST /WAIT /GLOB:xx
  451.     -------------------------------------------------------------------
  452.  
  453.     /BBS:xxx
  454.     --------
  455.     Use  alternate  MSGTOSS.BBS  file.   This is useful for  those  who
  456.     need  to  separate various *.BBS files and who use a  multitude  of
  457.  
  458.                                    Page - 7
  459.  
  460.  
  461.  
  462.  
  463.  
  464.                       MSGTOSS 2.0 Command Line Switches
  465.  
  466.     mail  processing  utilities.   In  other words,  if  you  use  this
  467.     switch, you are probably a HUB of some sort.
  468.  
  469.     Used with: /TOSS /SCAN /SIZE /MWRST /STAT /TEST /WAIT /GLOB:xx
  470.     ------------------------------------------------------------------
  471.  
  472.     /LOCK
  473.     ------
  474.     Invoke  multi-tasking/network file locking protocols in  accordance
  475.     with the LOCKTYPE----> parameter (see MSGCFG.REF).   Available pro-
  476.     tocols include DESQVIEW, NETBIOS, PC-NET and 10-NET.
  477.  
  478.     MSGTOSS    adheres  to  standard  file/record   locking   protocols
  479.     used    by  RBBS-PC  when  tossing/purging/sizing  message   bases.
  480.     MSGTOSS  will flash "status"  lights in the lower right-hand corner
  481.     of  the status of the LOCKING mechanism for both the USERS and MES-
  482.     SAGES files being processed.
  483.  
  484.     When  using NETBIOS,  MSGTOSS will use the MESSAGES----> parameter,
  485.     to determine which directory to write/create the IBMFLAGS file used
  486.     with NETBIOS.
  487.  
  488.     For more information,  see LOCKTYPE--->, LOCKTIME--->, LOCKWAIT--->
  489.     (in MSGCFG.REF) and MULTITASKING/NETWORK SUPPORT (in MSGTOSS.DOC).
  490.     ------------------------------------------------------------------
  491.  
  492.     /FIX
  493.     ------
  494.     If  you add the switch /FIX to the command line,  then MSGTOSS will
  495.     automatically SHELL to FIXMSG (Version 1.4,  Mike Zakharoff, avail-
  496.     able  as  FIXMSG14.xxx)  if  it  detects  a  corrupt  message  file
  497.     while  doing the purge.   It will execute FIXMSG twice,  and if  it
  498.     still fails to correct the problem MSGTOSS will abort.
  499.  
  500.     NOTE: Also see /FIXC.
  501.  
  502.     Used with: /TOSS /SCAN /SIZE /MWRST /STAT /TEST
  503.     ------------------------------------------------------------------
  504.  
  505.     /FIXC
  506.     ------
  507.     If  you use the switch /FIXC switch (vice just /FIX),  MSGTOSS will
  508.     do  the same as /FIX,  but if the repair failed will copy the BLANK
  509.     message  base  (model) as specified by the  BLANKMSG--->  parameter
  510.     over the corrupt message base,  and rename it to *.BAD.   This pre-
  511.     vents MSGTOSS from aborting due to a corrupt message base.
  512.  
  513.     Used with: /TOSS /SCAN /SIZE /MWRST /STAT /TEST
  514.     ------------------------------------------------------------------
  515.  
  516.     /WDIR
  517.     ------
  518.     To  obtain  faster purging,  mailwaiting and sizing MSGTOSS can  be
  519.     configured to use a work directory.   This is set via the WORKDIR--
  520.     --> parameter.   If a RAM disk, MSGTOSS will first copy the message
  521.     base  to  the RAM disk (if enough room exists) and will  purge  the
  522.     message base as required.  After purging, MSGTOSS will then copy it
  523.  
  524.                                    Page - 8
  525.  
  526.  
  527.  
  528.  
  529.  
  530.                       MSGTOSS 2.0 Command Line Switches
  531.  
  532.     back  automatically.   In addition,  if paging excess users to  the
  533.     disk  is required,  MSGTOSS will use the work directory for  faster
  534.     operation.  MSGTOSS will also use this directory for other disk in-
  535.     tensive tasks when needed.
  536.  
  537.     NOTE: If using multi-tasking/network support, MSGTOSS will not copy
  538.           the  message  base to the ram disk,  as a possibility  exists
  539.           where users may be on-line.
  540.  
  541.     Used with: /TOSS /SCAN /SIZE /MWRST
  542.  
  543.     NOTE: Does NOT have to be a RAM disk.
  544.     ------------------------------------------------------------------
  545.  
  546.     /AREA:xxx,xxx,xxx
  547.     ------
  548.     Allows tossing only one selected echo area (/AREA:COMM) or     mul-
  549.     tiple  echo  areas (separated by commas).  The use of this  command
  550.     WILL  NOT  delete the *.PKT file after completion of tossing UNLESS
  551.     all  of  the  messages happened to be tossed  properly.   In  other
  552.     words, the *.PKT files will still be available for further process-
  553.     ing.  Example:
  554.  
  555.     MSGTOSS /TOSS /PREP /AREA:COMM
  556.  
  557.     Will ONLY toss the echomail in the COMM conference
  558.  
  559.     Used with: /TOSS /SCAN
  560.     ------------------------------------------------------------------
  561.  
  562.     /AREAF:File.Ext
  563.     ------
  564.     This  works in conjunction with /SCAN,  /RSCAN or /TOSS,  and func-
  565.     tions  exactly the same as the /AREA:xxxx,xxxx,xxx  switch,  except
  566.     the echo names are derived from a plain ascii file.   The most use-
  567.     ful  purpose  for this is for FIDO scanning where you  can  process
  568.     CONFMAIL.OUT that is generated by most fido editors,  and only scan
  569.     those areas listed.
  570.  
  571.     A plain ascii file exists that contains a list of echos to     pro-
  572.     cess, as follows:
  573.  
  574.        RBBS-PC
  575.        NETMAIL
  576.        COMM
  577.        FORSALE
  578.  
  579.     If this file is called CONFMAIL.OUT then execute as follows.
  580.  
  581.     MSGTOSS /SCAN /FIDO /RBBS .....  /AREAF:CONFMAIL.OUT
  582.  
  583.     Used with: /TOSS /SCAN
  584.     ------------------------------------------------------------------
  585.  
  586.  
  587.  
  588.  
  589.  
  590.                                    Page - 9
  591.  
  592.  
  593.  
  594.  
  595.  
  596.                       MSGTOSS 2.0 Command Line Switches
  597.  
  598.  
  599.     /DDA
  600.     ----
  601.     Don't Display (tossing and scanning) Activity.   Will significantly
  602.     increase  the speed of tossing and scanning,  as informational mes-
  603.     sages regarding which messages are tossed where will be suppressed.
  604.     Also see /NSTOP switch.
  605.  
  606.     Used with: /TOSS /SCAN
  607.     ------------------------------------------------------------------
  608.  
  609.     /COUNT
  610.     ------
  611.     The  /COUNT switch is used with the /STAT & /TEST  switches,  which
  612.     will  force  MsgToss to do an actual count of the messages in  each
  613.     area  instead  of estimating.   This will allow for  non-sequential
  614.     numbering  that may result from deleted messages.   If an error  is
  615.     encountered  during the count process,  MsgToss will attempt to fix
  616.     the  message base depending if the command line contained  /FIX  or
  617.     /FIXC switches.
  618.  
  619.     Used with: /STAT /TEST
  620.     ------------------------------------------------------------------
  621.  
  622.  
  623.  
  624.  
  625.  
  626.  
  627.  
  628.  
  629.  
  630.  
  631.  
  632.  
  633.  
  634.  
  635.  
  636.  
  637.  
  638.  
  639.  
  640.  
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.  
  656.                                   Page - 10
  657.  
  658.  
  659.  
  660.  
  661.  
  662.                       MSGTOSS 2.0 Command Line Switches
  663.  
  664.  
  665. Toss RBBS, FIDO & NETMAIL messages - /TOSS
  666. ------------------------------------------
  667.  
  668.  
  669. /TOSS SWITCHES (BASIC)
  670. --------------
  671.  
  672.     /TOSS
  673.     ------
  674.     The   /TOSS  major  command line switch signals MSGTOSS to start  a
  675.     carefully   planned  sequence,   used  more often than  any   other
  676.     switch.  There are 7 phases to the TOSSING of messages:
  677.  
  678.        1) Un-Pack mail packets
  679.        2) Identify domain/zone/net/node of *.PKT files
  680.        3) Analyze *.PKT files
  681.        4) Purge/expand RBBS message bases as required
  682.        5) Toss messages (RBBS message bases or Fido)
  683.        6) Set the mailwaiting bit for conference users
  684.        7) Create a MSGTOSS.LOG file for message base activity
  685.        8) Create miscellaneous BAT/CMD/CTL files for other maintenance.
  686.  
  687.     NOTE: See MSGTOSS THEORY OF OPERATION for a description of each
  688.           phase of the above.
  689.     ------------------------------------------------------------------
  690.  
  691.     /PREP
  692.     ------
  693.     Will pre-purge the message bases before tossing (used  most often).
  694.  
  695.     MSGTOSS  will either PURGE the message bases  or EXPAND  (or  both)
  696.     prior to tossing.  If you specified the  /PREP  switch (pre-purge),
  697.     MSGTOSS  will first load all of the USERS in a  particular     con-
  698.     ference  in  memory  (see  NOTE:),   and  will  commence  to  purge
  699.     non-user    messages.   This is accomplished via a  'pack-in-place'
  700.     method,  where  the    messages  flagged to keep will be 'shuffled'
  701.     to the beginning  of the    RBBS message base,  as others are being
  702.     deleted.
  703.  
  704.     NOTE: MSGTOSS will purge ONLY ENOUGH messages for successful impor-
  705.           tation.   Therefore,  if only 2-3 messages are received in  a
  706.           particular  conference,   then  roughly the same  amount will
  707.           be purged (if there isn't enough space to begin with).
  708.  
  709.     NOTE: For any sort of tossing activity, /PREP or /PREX is required.
  710.           This  informs MSGTOSS what to do in case there is not  enough
  711.           room available in the respective RBBS message base.
  712.  
  713.     NOTE: If  the BBS keyword HIST:1 is true,  then all purged messages
  714.           will be exported (text format) to a history file.
  715.     ------------------------------------------------------------------
  716.  
  717.     /PREX
  718.     ------
  719.     If  you specified the /PREX (pre-expand) switch,  then MSGTOSS will
  720.     simply EXPAND the message base as it sees fit and continue on.   At
  721.  
  722.                                   Page - 11
  723.  
  724.  
  725.  
  726.  
  727.  
  728.                       MSGTOSS 2.0 Command Line Switches
  729.  
  730.     a  later time (say at a night event) to can CHOP the message  bases
  731.     back  down to their original size by issuing the /SIZE or  /SIZE-UP
  732.     switches.
  733.     ------------------------------------------------------------------
  734.  
  735.     /TUNK
  736.     ------
  737.     The  /TUNK  switch allows tossing UNKNOWN messages from #.MSG  into
  738.     M.DEF  format.  If you specify /TUNK on the command  line,  MSGTOSS
  739.     will (if the UNKNOWN area is a FIDO sub directory) analyze and toss
  740.     messages that were previously UNKNOWN.
  741.  
  742.     NOTE: Assuming that a previously UNKNOWN message becomes KNOWN, and
  743.           the  area  UNKNOWN is a Fido-Style area,  you can toss  these
  744.           messages  into  RBBS  format  via the  /TUNK  (toss  unknown)
  745.           switch.   The  most likely reason for a message to be unknown
  746.           is  either an omission of the subject area in the MSGTOSS.BBS
  747.           file or an improper link between node and host.
  748.  
  749.     The  /TUNK switch is meant to be used only when necessary.  Placing
  750.     it permanently on the /TOSS command line will slow down processing.
  751.     It  was not meant to be something used to import #.MSG on a regular
  752.     basis. Any messages that are still UNKNOWN will be ignored.
  753.  
  754.     NOTE: It  is  not  necessary  to have a *.PKT file  to  process  to
  755.           execute this switch,  so the minimum command line is 'MSGTOSS
  756.           /TOSS/TUNK ....other switches' for this.
  757.     ------------------------------------------------------------------
  758.  
  759.     /TCAP
  760.     -----
  761.     The  /TCAP  (Toss MSGCAPTURE) switch provides the same services  as
  762.     the /TUNK switch, but for messages 'captured' in the MSGCAPTURE di-
  763.     rectory.  Also see CAPTURE-----> and CAPT:x
  764.  
  765.     NOTE: Those  familiar  with the /TCAP switch usually use a  nightly
  766.           event to toss captured messages.
  767.     ------------------------------------------------------------------
  768.  
  769.     /NSTOP
  770.     ------
  771.     MSGTOSS allows interruption of tossing or analyzing by simply hitt-
  772.     ing any key.   If this occurs,  MSGTOSS will abort as soon as it is
  773.     done with the current *.PKT file.  Using /NSTOP will allow slightly
  774.     FASTER operation because it will not have to check for keyboard in-
  775.     put.  Also see /DDA switch.
  776.     -------------------------------------------------------------------
  777.  
  778.     /LOCK   (COMMON)
  779.     ------
  780.     Invoke multi-tasking/network support.  See page 8 for more details.
  781.     -------------------------------------------------------------------
  782.  
  783.     /FIX   (COMMON)
  784.     ------
  785.     Auto-repair RBBS M.DEF(s) via FIXMSG.  See page 8 for more details.
  786.     ------------------------------------------------------------------
  787.  
  788.                                   Page - 12
  789.  
  790.  
  791.  
  792.  
  793.  
  794.                       MSGTOSS 2.0 Command Line Switches
  795.  
  796.  
  797.     /FIXC  (COMMON)
  798.     ------
  799.     Auto-repair RBBS M.DEF(s) via FIXMSG.  See page 8 for more details.
  800.     ------------------------------------------------------------------
  801.  
  802.     /WDIR  (COMMON)
  803.     ------
  804.     Use RAM disk for faster operation.  See page 8 for more details.
  805.     ------------------------------------------------------------------
  806.  
  807.     /DDA   (COMMON)
  808.     ----
  809.     Don't display (toss/scan) activity.  See page 10 for more details.
  810.     ------------------------------------------------------------------
  811.  
  812. /TOSS SWITCHES (ADVANCED)
  813. --------------
  814.  
  815.     /FEED
  816.     ------
  817.     If you are a HUB, or you support POINTS, MSGTOSS can simultaneously
  818.     create  *.OUT  files  addressed to your nodes/points by  using  the
  819.     /FEED  switch on your /TOSS command line.   Using this switch  will
  820.     automatically  feed  your nodes & points as MSGTOSS is  tossing  to
  821.     your RBBS message bases (M.DEF) or #.MSG format.
  822.  
  823.     NOTE: The use of the switch  requires alot of more extra processing
  824.           (SEEN-BY lines, etc.).  If you are simply a static node DON'T
  825.           use this switch.
  826.  
  827.     NOTE: The /FMAX:xxx switch is normally used with this switch.
  828.     ------------------------------------------------------------------
  829.  
  830.     /FMAX:xxx
  831.     ------
  832.     For HUBS,  when doing a /FEED,  MSGTOSS will either exit processing
  833.     or  SHELL  out  to a packer when /FMAX:xxx messages have  been  ex-
  834.     ported.   This allows MSGTOSS to gracefully exit,  pack up to *.OUT
  835.     file generated, then continue processing until all are complete.
  836.  
  837.     The  CFG entry is PACKERCMD----> The switch is /FMAX:xxx (short for
  838.     /FEED Maximum) And they work together.    For instance:
  839.  
  840.     PACKERCMD--->QMAIL -PACK --or--
  841.     PACKERCMD--->OMMM --or--
  842.     PACKERCMD--->MAKEARC etc.
  843.  
  844.     And /FMAX:1000 is added as a switch:
  845.  
  846.     MSGTOSS will,  after exporting 1000 messages (in any combination to
  847.     any  set of nodes),  and done with the current PKT file,  close ALL
  848.     *.OUT files,  and SHELL out to PACKERCMD.   When done,  will return
  849.     back, re-open *.OUT files, and continue on. 
  850.  
  851.     NOTE: If PACKERCMD---> is blank ("") then MSGTOSS will exit.
  852.  
  853.  
  854.                                   Page - 13
  855.  
  856.  
  857.  
  858.  
  859.  
  860.                       MSGTOSS 2.0 Command Line Switches
  861.  
  862.     For more information, see PACKERCMD---> in MSGCFG.DOC.
  863.     ------------------------------------------------------------------
  864.  
  865.     /KNET
  866.     ------
  867.     Kill (ignore) NETMAIL messages.  This is useful for HUB's where an-
  868.     other   tosser   handles   NETMAIL  and   routing   (like   QMAIL).
  869.     Previously,  you would have to use a 'dummy' directory and clear it
  870.     out  after a toss.   This is normally used in conjunction with  the
  871.     /KRTE switch also.
  872.  
  873.     NOTE: You still need to have an area called NETMAIL.
  874.     ------------------------------------------------------------------
  875.  
  876.     /KUNK
  877.     ------
  878.     Kill (ignore) messages that have UNKNOWN areas.  This is useful for
  879.     HUB's where another tosser handles feeding of downstream nodes, but
  880.     you want to use the complete *.PKT files,  even though they contain
  881.     echomail that your local system (M.DEFs) do not carry.  This switch
  882.     is  sometimes used with the /DKP (Don't Kill Packets) switch to al-
  883.     low this 'double processing'.
  884.  
  885.     NOTE: You still need to have an area called UNKNOWN.
  886.     ------------------------------------------------------------------
  887.  
  888.     /KRTE
  889.     ------
  890.     Kill  (ignore) ROUTEMAIL messages.   This is useful for HUB's where
  891.     another  tosser handles NETMAIL not addressed to your system  (like
  892.     QMAIL).   Previously, you would have to use a 'dummy' directory and
  893.     clear it out after a toss.
  894.  
  895.     NOTE: The area ROUTEMAIL is still optional, but having it and using
  896.           this switch serves no useful purpose.  Normally, this is used
  897.           with the /KNET switch.
  898.     ------------------------------------------------------------------
  899.  
  900.     /PKTS:xx
  901.     ------
  902.     Process only if there are at least xx packets present.   Useful for
  903.     HUBS where small *.PKTs trickle in, and you only want to go through
  904.     a  complete tossing process until there are enough *.PKTs available
  905.     to  warrant it.   Will gracefully exit with errorlevel if less than
  906.     xx packets are present.
  907.     ------------------------------------------------------------------
  908.  
  909.     /DLOG
  910.     ------
  911.     Will   append   the   following  information  to  a   file   called
  912.     MSGTOSS.DUP whenever a duplicate is detected.  MSGTOSS.DUP contains
  913.     the following information...   DATE,   PKT,  PKT MSG,  AREA and WHO
  914.     FROM (Net/Node) for tracking information.  
  915.  
  916.     NOTE: This only applies when the CDUP:1 keyword is active.
  917.     ------------------------------------------------------------------
  918.  
  919.  
  920.                                   Page - 14
  921.  
  922.  
  923.  
  924.  
  925.  
  926.                       MSGTOSS 2.0 Command Line Switches
  927.  
  928.     /DKP
  929.     ------
  930.     Don't Kill Packets.   Intended in hubbing situations where you wish
  931.     to  keep the *.PKT files for further processing.   This will delete
  932.     the  *.IDX  file but will leave the *.PKT file available for  other
  933.     processors (like for HUB work).   Be extremely careful,  as if your
  934.     other  mail  processor  crashed  and *.PKT files are  left  in  the
  935.     MSGTOSS files directory, then MSGTOSS will happily re-process them.
  936.     For  safety      sake,  it would be better to IMMEDIATELY move  the
  937.     *.PKT files to another directory after MSGTOSS has processed them.
  938.     ------------------------------------------------------------------
  939.  
  940.     /OPUS
  941.     ------
  942.     MSGTOSS  now  supports OPUS-Style dates (date-written  &  date-arr-
  943.     rived)  for  #.MSG files.   Some utilities such as Hector  Santos's
  944.     Silver  Express  (off-line reader for RBBS,  among others)  require
  945.     these special dates to be written in the message header.  
  946.  
  947.     NOTE: Don't add it unless necessary,  as it requires a little extra
  948.           processing. 
  949.     ------------------------------------------------------------------
  950.  
  951.     /MUSER:xx
  952.     ------
  953.     While  MSGTOSS is tossing mail,  you can have it constantly  update
  954.     one  of  the RBBS-PC node-records of the main message base via  the
  955.     /MUSER:x  command line switch,  where x is the node number  MSGTOSS
  956.     will permanently occupy.  Example:
  957.  
  958.     You  run  TWO nodes.   If you enter /MUSER:3 on the  /TOSS  command
  959.     line,  MSGTOSS  will update node record #3 of the main message base
  960.     and act just like another user on-line.   Users who enter the [W]ho
  961.     function on the main menu will then see a display similar to this:
  962.  
  963. Node 1 Online at 9600 BAUD: SYSOP KENT ,WA
  964. Node 2 Online at 2400 BAUD: JOHN HENDRICKS SEATTLE,WA
  965. Node 3 Online at 9600 BAUD: MsgToss 2.0 - Mail System PURGING MSG BASES
  966.  
  967.     When  MSGTOSS goes off-line,  the node record will still exist  and
  968.     the SYSOP can then see when the last mail run was.  Creative sysops
  969.     can  disable RBBS-PC(s) requirement to show 'Waiting for next  cal-
  970.     ler'  then  the node record actually shows 'off-line'  by making  a
  971.     simple code change in the RBBS-PC '[W]hos on' source code.
  972.  
  973.     NOTE: See MSGTOSS.DOC, "Modify RBBSSUB2.BAS to Support /MUSER:x" to
  974.           find  the  code  modification to RBSSUB2.BAS to  provide  the
  975.           above feature.
  976.  
  977.     Then  all  users will see even those that are  off-line,  including
  978.     MSGTOSS, example:
  979.  
  980. Node 3 Offline at 300 BAUD: MsgToss 2.0 - Mail System Last: 01-23 15:14
  981.  
  982.     MSGTOSS  will  now permanently occupy position number three of  the
  983.     MAIN  RBBS  MESSAGE base...   this means that when MSGTOSS is  busy
  984.     tossing,  purging, mailwaiting...  etc.  a REAL USER on your system
  985.  
  986.                                   Page - 15
  987.  
  988.  
  989.  
  990.  
  991.  
  992.                       MSGTOSS 2.0 Command Line Switches
  993.  
  994.     can execute the [W]ho Else is ON function on the main menu, and the
  995.     user  can see that MSGTOSS is currently ONLINE,  tossing,  purging,
  996.     etc...   The  user  is MSGTOSS,  and the city/state is the  MSGTOSS
  997.     'status' of what it is currently doing. 
  998.  
  999.     Make sure you DON'T specify a node number where its possible that a
  1000.     REAL  user could be on-line..    MSGTOSS should always have its OWN
  1001.     node line,  so its always there (like #3).  If you specify /LOCK on
  1002.     the command line, then MSGTOSS will use file locking procedures (as
  1003.     it should) before it messes with the node records.
  1004.  
  1005.     If  you enter 'MSGTOSS /MUSER:0'  then MSGTOSS will clear any  node
  1006.     records that contain the text "MSGTOSS".
  1007.  
  1008.     If you DON'T run multiple nodes, then this switch is worthless, un-
  1009.     less  you  use one of those 'This was the LAST user on the  system'
  1010.     utilities.
  1011.     ------------------------------------------------------------------
  1012.  
  1013.     /CFG:File.Ext   (COMMON)
  1014.     ------
  1015.     Use alternate MSGTOSS.CFG file.  See page 7 for more details.
  1016.     ------------------------------------------------------------------
  1017.  
  1018.     /BBS:File.Ext   (COMMON)
  1019.     ------
  1020.     Use alternate MSGTOSS.BBS file.  See page 7 for more details.
  1021.     ------------------------------------------------------------------
  1022.  
  1023.     /AREA:xxx,xxx,xxx   (COMMON)
  1024.     ------
  1025.     Only toss/scan /AREA:xxx,xxx,xxx.  See page 9 for more details.
  1026.     ------------------------------------------------------------------
  1027.  
  1028.     /AREAF:File.Ext     (COMMON)
  1029.     ------
  1030.     Only toss/scan areas in File.Ext.  See page 9 for more details.
  1031.     ------------------------------------------------------------------
  1032. ----------------------------------------------------------------------
  1033.  
  1034.  
  1035.  
  1036.  
  1037.  
  1038.  
  1039.  
  1040.  
  1041.  
  1042.  
  1043.  
  1044.  
  1045.  
  1046.  
  1047.  
  1048.  
  1049.  
  1050.  
  1051.  
  1052.                                   Page - 16
  1053.  
  1054.  
  1055.  
  1056.  
  1057.  
  1058.                       MSGTOSS 2.0 Command Line Switches
  1059.  
  1060.  
  1061. Scan (export) new locally entered mail - /SCAN
  1062. ----------------------------------------------
  1063.  
  1064.  
  1065. MSGTOSS will scan M.DEF or #.MSG messages for new messages,  and export
  1066. them  to  all the NET/NODES in the MSGTOSS.BBS file for its  associated
  1067. area.  More information on this exists in MSGTOSS.DOC (/SCAN section).
  1068.  
  1069. For RBBS message bases,  when MSGTOSS has finished exporting a message,
  1070. it will append a '<XMT>'  to the bottom of the message,  allowing users
  1071. or the sysop know that the message has been exported.  During a MSGTOSS
  1072. purge  operation  (/PREP or /SIZE),  MSGTOSS will replace  these  <XMT>
  1073. lines  with the default origin line,  or the origin line as defined  by
  1074. the ORGN:  keyword(s).  The reason for this odd method is to allow full
  1075. scanning features while users are on-line.
  1076.  
  1077. When exporting a FIDO message (#.MSG), msgtoss will set the 'sent' bit,
  1078. preventing re-exportation.
  1079.  
  1080. The  whole /SCAN operation can be executed safely even though users are
  1081. on-line,  as MSGTOSS will use full multi-tasking/network record locking
  1082. protocols (using  /LOCK,  as defined by LOCKTYPE----->) during a /SCAN,
  1083. allowing fully safe scanning.
  1084.  
  1085. MIRROR SCANNING
  1086. ---------------
  1087. MSGTOSS 2.0+ provides a notable feature called "mirror-scanning", where
  1088. if you have a double-tossed area (RBBS + FIDO, for one area), then if a
  1089. user entered a message in the RBBS conference, when exported, will also
  1090. create a "carbon copy",  complete with Origin: line,  in the Fido-Style
  1091. directory  as well.   The same applies to when a user (or yourself) en-
  1092. ters a message in a Fido-Style conference, when exported, will create a
  1093. carbon copy in the RBBS message base.
  1094.  
  1095. For maximum configuration possibilities, you can specify /SCAN /RBBS to
  1096. scan  just  the M.DEF message bases,  or /SCAN /FIDO to scan  just  the
  1097. #.MSG areas, or you can do both by entering /SCAN /RBBS /FIDO.  
  1098.  
  1099. Basically, if you want to scan M.DEFs (only) then...
  1100.  
  1101.     MSGTOSS /SCAN /RBBS .....  [other switches]
  1102.  
  1103. If you want to scan BOTH #.MSG and M.DEFs, then ...
  1104.  
  1105.     MSGTOSS /SCAN /FIDO /RBBS ....  [other switches]
  1106.  
  1107.     Examples:  MSGTOSS /SCAN /FIDO /LOCK           (fido only)
  1108.                MSGTOSS /SCAN /FIDO /RBBS /LOCK     (rbbs + fido)
  1109.  
  1110. /SCAN SWITCHES (BASIC)
  1111. --------------
  1112.  
  1113.     /SCAN
  1114.     ------
  1115.     Perform  a SCAN (export) operation on either RBBS message bases  or
  1116.     FIDO sub-directories (or both).  See text above.
  1117.  
  1118.                                   Page - 17
  1119.  
  1120.  
  1121.  
  1122.  
  1123.  
  1124.                       MSGTOSS 2.0 Command Line Switches
  1125.  
  1126.  
  1127.     ------------------------------------------------------------------
  1128.  
  1129.     /RBBS
  1130.     ------
  1131.     Include RBBS message bases (M.DEF) during a /SCAN operation.
  1132.  
  1133.     NOTE: Also see /FIDO command line switch.
  1134.     ------------------------------------------------------------------
  1135.  
  1136.     /FIDO
  1137.     ------
  1138.     Include FIDO messages (#.MSG) during a /SCAN operation.
  1139.  
  1140.     NOTE: Also see /RBBS command line switch
  1141.     ------------------------------------------------------------------
  1142.  
  1143.     /LOCK   (COMMON)
  1144.     ------
  1145.     Invoke multi-tasking/network support.  See page 8 for more details.
  1146.     ------------------------------------------------------------------
  1147.  
  1148.     /FIX    (COMMON)
  1149.     ------
  1150.     Auto-repair RBBS M.DEF(s) via FIXMSG.  See page 8 for more details.
  1151.     ------------------------------------------------------------------
  1152.  
  1153.     /FIXC   (COMMON)
  1154.     ------
  1155.     Auto-repair RBBS M.DEF(s) via FIXMSG.  See page 8 for more details.
  1156.     ------------------------------------------------------------------
  1157.  
  1158.     /DDA    (COMMON)
  1159.     ------
  1160.     Don't display (toss/scan) activity.  See page 10 for more details.
  1161.     ------------------------------------------------------------------
  1162. ----------------------------------------------------------------------
  1163.  
  1164. /SCAN SWITCHES (ADVANCED)
  1165. --------------
  1166.  
  1167.     /RSCAN:zone:net/node  (with /AREA: or /AREAF:)
  1168.     ------
  1169.     For  HUBS,  The /RSCAN:  switch allows re-scanning selected message
  1170.     areas  for a particular net/node.   This is normally used in a hub-
  1171.     bing situation,  where you are adding a new net/node to a specified
  1172.     area in your MSGTOSS.BBS, and you want to send all messages to that
  1173.     new net/node.  Example:
  1174.  
  1175.        MSGTOSS /RSCAN:[zone]:[net]/[node] /AREA:science,comm
  1176.  
  1177.     NOTE: An  /RSCAN:  operation  requires  either  /AREA:  or  /AREAF:
  1178.           command line switch.
  1179.  
  1180.     NOTE: It  may  be necessary to use the /HWM command line switch  to
  1181.           provide a complete rescan.
  1182.     ------------------------------------------------------------------
  1183.  
  1184.                                   Page - 18
  1185.  
  1186.  
  1187.  
  1188.  
  1189.  
  1190.                       MSGTOSS 2.0 Command Line Switches
  1191.  
  1192.  
  1193.     /HWM
  1194.     ------
  1195.     MSGTOSS  maintains  two different High Water Marks (HWMs) for   the
  1196.     /SCAN  operation.   For  RBBS message bases,  it utilizes  position
  1197.     121-122 of the RBBS checkpoint record(s) to store the HWM.  For FI-
  1198.     DO  areas,  it uses message number 1 (1.MSG),  position 185-186  to
  1199.     store this number.
  1200.  
  1201.     Normally,  MSGTOSS will first check the value of the HWM and ignore
  1202.     all messages whose value is less than the HWM.  The /HWM switch ov-
  1203.     er-rides  the  true High Water Mark to be in the beginning  of  the
  1204.     RBBS  message  base or 1.MSG.   Basically,  if you think a  message
  1205.     wasn't exported, add /HWM to the scan command line, like this...
  1206.  
  1207.     MSGTOSS /SCAN /RBBS /FIDO /HWM
  1208.  
  1209.     And MSGTOSS will start at the beginning of the message base to look
  1210.     for non-exported mail.
  1211.  
  1212.     In addition,  this is also usually used with the /RSCAN:  switch to
  1213.     force MSGTOSS to re-scan all messages to a particular net/node.
  1214.  
  1215.     NOTE: This takes more time to complete a /SCAN.
  1216.     ------------------------------------------------------------------
  1217.  
  1218.     /CFG:File.Ext   (COMMON)
  1219.     ------
  1220.     Use alternate MSGTOSS.CFG file.  See page 7 for more details.
  1221.     ------------------------------------------------------------------
  1222.  
  1223.     /BBS:File.Ext   (COMMON)
  1224.     ------
  1225.     Use alternate MSGTOSS.BBS file.  See page 7 for more details.
  1226.     ------------------------------------------------------------------
  1227.  
  1228.     /WDIR           (COMMON) 
  1229.     ------
  1230.     Use RAM disk for faster operation.  See page 8 for more details.
  1231.     ------------------------------------------------------------------
  1232.  
  1233.     /AREA:xxx,xxx,xxx   (COMMON)
  1234.     ------
  1235.     Only toss/scan /AREA:xxx,xxx,xxx.  See page 9 for more details.
  1236.     ------------------------------------------------------------------
  1237.  
  1238.     /AREAF:File.Ext     (COMMON) 
  1239.     ------
  1240.     Only toss/scan areas in File.Ext.  See page 9 for more details.
  1241.     ------------------------------------------------------------------
  1242. ----------------------------------------------------------------------
  1243.  
  1244.  
  1245.  
  1246.  
  1247.  
  1248.  
  1249.  
  1250.                                   Page - 19
  1251.  
  1252.  
  1253.  
  1254.  
  1255.  
  1256.                       MSGTOSS 2.0 Command Line Switches
  1257.  
  1258.  
  1259. Chop message bases to preset SIZE - /SIZE
  1260. -----------------------------------------
  1261.  
  1262.  
  1263. /SIZE SWITCHES
  1264. --------------
  1265.  
  1266. /SIZE or /SIZE-UP
  1267. -----------------
  1268. Use  the  /SIZE switches to keep control of the sizes of  your  message
  1269. bases.   You can do this by simply altering the RECS:xxxx values in the
  1270. MSGTOSS.BBS file and executing:
  1271.  
  1272.    MSGTOSS /SIZE     ... other switches   -- or --
  1273.    MSGTOSS /SIZE-UP  ... other switches
  1274.  
  1275. The  /SIZE-UP switch will increase message sizes (and CHOP) as required
  1276. to match the RECS:xxxx values,  where the /SIZE will ignore the message
  1277. base if the size is smaller than or equal to the RECS:xxxx value(s). 
  1278.  
  1279. Because MSGTOSS doesn't think twice about expanding a message base dur-
  1280. ing  a  /TOSS when it needs it,  this built-in 'smart sizing'  code  is
  1281. built into MSGTOSS to easily maintain tight control on the sizes of the
  1282. message bases.   In-fact,  these built-in utilities are superior to the
  1283. RBBS-PC  CONFIG utility.   After MSGTOSS is initially set up  properly,
  1284. adding a simple line to your daily maintenance batch file:
  1285.  
  1286.    MSGTOSS /SIZE (or /SIZE-UP) ... other switches
  1287.  
  1288. Will  chop the message bases back down to a predetermined level in  one
  1289. swipe.   So again, if MSGTOSS expands a message base,  that one command
  1290. will  cleanly  and easily return it back to its  original  size,  using
  1291. smart purging techniques.     Remember, MSGTOSS will ONLY expand a mes-
  1292. sage  base if it   absolutely needs to.   If after the built-in purging
  1293. there  is still not enough message records,  then and only then will it
  1294. expand a message base.
  1295.  
  1296. NOTE: If the BBS keyword HIST:1 is true,  then all purged messages will
  1297.       be exported (in text format) into a history file.  See MSGBBS.DOC
  1298.       for more info.
  1299.  
  1300. For  those  sysops who decide to run /TOSS with the /PREX  (pre-expand)
  1301. switch vice /PREP (pre-purge) will absolutely need to add a /SIZE oper-
  1302. ation  to  a daily maintenance event.   Allowing the message  bases  to
  1303. expand  as required will (sooner than later) exceed the RBBS maximum of
  1304. 999 messages, causing problems for MSGTOSS.
  1305.  
  1306. NOTE: You  really  should place 'MSGTOSS /SIZE'  as part of your  daily
  1307.       maintenance routines.
  1308.  
  1309.     /SIZE
  1310.     -----
  1311.     Will CHOP message bases back down to RECS:xxxx in MSGTOSS.BBS.  
  1312.  
  1313.     NOTE: Also see text above.
  1314.     ------------------------------------------------------------------
  1315.  
  1316.                                   Page - 20
  1317.  
  1318.  
  1319.  
  1320.  
  1321.  
  1322.                       MSGTOSS 2.0 Command Line Switches
  1323.  
  1324.  
  1325.     /SIZE-UP
  1326.     ------
  1327.     Will Increase (if required) and CHOP to match RECS:xxxx
  1328.  
  1329.     NOTE: Also see text above.
  1330.     ------------------------------------------------------------------
  1331.  
  1332.     /CFG:File.Ext   (COMMON)
  1333.     ------
  1334.     Use alternate MSGTOSS.CFG file.  See page 7 for more details.
  1335.     ------------------------------------------------------------------
  1336.  
  1337.     /BBS:File.Ext   (COMMON)
  1338.     ------
  1339.     Use alternate MSGTOSS.BBS file.  See page 7 for more details.
  1340.     ------------------------------------------------------------------
  1341.  
  1342.     /LOCK   (COMMON)
  1343.     ------
  1344.     Invoke multi-tasking/network support.  See page 8 for more details.
  1345.     ------------------------------------------------------------------
  1346.  
  1347.     /FIX    (COMMON)
  1348.     ------
  1349.     Auto-repair RBBS M.DEF(s) via FIXMSG.  See page 8 for more details.
  1350.     ------------------------------------------------------------------
  1351.  
  1352.     /FIXC   (COMMON)
  1353.     ------
  1354.     Auto-repair RBBS M.DEF(s) via FIXMSG.  See page 8 for more details.
  1355.     ------------------------------------------------------------------
  1356.  
  1357.     /WDIR   (COMMON)
  1358.     ------
  1359.     Use RAM disk for faster operation.  See page 8 for more details.
  1360.     ------------------------------------------------------------------
  1361.  
  1362. ----------------------------------------------------------------------
  1363.  
  1364.  
  1365.  
  1366.  
  1367.  
  1368.  
  1369.  
  1370.  
  1371.  
  1372.  
  1373.  
  1374.  
  1375.  
  1376.  
  1377.  
  1378.  
  1379.  
  1380.  
  1381.  
  1382.                                   Page - 21
  1383.  
  1384.  
  1385.  
  1386.  
  1387.  
  1388.                       MSGTOSS 2.0 Command Line Switches
  1389.  
  1390.  
  1391. Reset users Mailwaiting Bit (all msgs) - /MWRST
  1392. -----------------------------------------------
  1393.  
  1394. /MWRST SWITCHES
  1395. ---------------
  1396.  
  1397.     /MWRST
  1398.     ------
  1399.     Mailwaiting RESET...   Will first ZERO all mailwaiting bits for all
  1400.     users  for all conferences and re-hash.   Recommended every now and
  1401.     then for message maintenance or when first installing MSGTOSS.
  1402.  
  1403.     This switch provides a easy method of 'fixing'  mailwaiting bits in
  1404.     the RBBS User Bases.   The only other known utility that provides a
  1405.     similar feature is MAILWAIT (Version 1.0, Mike Zakharoff, available
  1406.     as MAILWA10.xxx).
  1407.  
  1408.     Using  this  utility at least once during installation  of  MSGTOSS
  1409.     will  prevent users from being notified of mail when none  actually
  1410.     exist.   MSGTOSS  will  (as  long the MWST:1 keyword is  active  in
  1411.     MSGTOSS.BBS  fro  the conference) automatically maintain the  mail-
  1412.     waiting bits to perfection. 
  1413.  
  1414.     NOTE: Weekly execution of this command is recommended.
  1415.     ------------------------------------------------------------------
  1416.  
  1417.     /CFG:File.Ext   (COMMON)
  1418.     ------
  1419.     Use alternate MSGTOSS.CFG file.  See page 7 for more details.
  1420.     ------------------------------------------------------------------
  1421.  
  1422.     /BBS:File.Ext   (COMMON)
  1423.     ------
  1424.     Use alternate MSGTOSS.BBS file.  See page 7 for more details.
  1425.     ------------------------------------------------------------------
  1426.  
  1427.     /LOCK   (COMMON)
  1428.     ------
  1429.     Invoke multi-tasking/network support.  See page 8 for more details.
  1430.     ------------------------------------------------------------------
  1431.  
  1432.     /FIX    (COMMON)
  1433.     ------
  1434.     Auto-repair RBBS M.DEF(s) via FIXMSG.  See page 8 for more details.
  1435.     ------------------------------------------------------------------
  1436.  
  1437.     /FIXC   (COMMON)
  1438.     ------
  1439.     Auto-repair RBBS M.DEF(s) via FIXMSG.  See page 8 for more details.
  1440.     ------------------------------------------------------------------
  1441.  
  1442.     /WDIR   (COMMON)
  1443.     ------
  1444.     Use RAM disk for faster operation.  See page 8 for more details.
  1445.     ------------------------------------------------------------------
  1446. ----------------------------------------------------------------------
  1447.  
  1448.                                   Page - 22
  1449.  
  1450.  
  1451.  
  1452.  
  1453.  
  1454.                       MSGTOSS 2.0 Command Line Switches
  1455.  
  1456.  
  1457. Report on message base statistics - /STAT
  1458. -----------------------------------------
  1459.  
  1460. Use  /STAT  to  monitor the status of your message bases.  Here  is  an
  1461. example of the /STAT parameter...
  1462.  
  1463. Conf     Num  #  Sec    Num  Recs Recs Pct   Max Last  Est  Msg  Est  HWM First
  1464. Name    User  N Level  Recs  Used Free Full Msgs  Msg  Msg Size  Cap  Msg   Msg
  1465. ------- ---- -- ----- ----- ----- ---- ---- ---- ---- ---- ---- ---- ---- -----
  1466. MESSAGE 1439  3  8224  1004   746  258   74  200  206  206  3.6  277    1 06-04
  1467. GENEAL     3  3    40  1004   887  117   88  200  143  143  6.2  161  107 01-21
  1468. COMM       6  3    40   800   716   84   90  160   89   89  8.0   99   63 01-20
  1469. CLIPPER    6  3    40   800   717   83   90  160   90   90  7.9  100   79 01-18
  1470. CONSULT    1  3    40   800   714   86   89  160   85   85  8.3   95   80 01-08
  1471. COOKING    2  3    40   800   720   80   90  160   79   79  9.1   87   15 01-22
  1472. C_PRGM     5  3     5   800   714   86   89  160   94   94  7.5  105   50 01-19
  1473. DBASE      2  3    40   800   355  445   44  160   51   49  7.1  111   49 01-20
  1474. FEMIN      3  3    40   800   700  100   88  160   59   59 11.8   67   56 01-13
  1475. FORSALE   11  3    40   800   707   93   88  160  140  140  5.0  158  138 01-05
  1476. HDCONF     4  3     5   800   718   82   90  160   98   98  7.3  109   68 01-19
  1477. HDSALE     5  3     5   800   716   84   90  160  149  149  4.8  166  125 01-20
  1478. HST        3  3     5   800   720   80   90  160   91   91  7.9  101   74 01-19
  1479. HUMOR      7  3    40   800   715   85   89  160  126  126  5.6  141  108 12-25
  1480. JOBS       7  3    40   800   712   88   89  160   77   77  9.2   86   74 01-07
  1481. OS2        1  3    40   800   712   88   89  160  100  100  7.1  112   99 01-16
  1482. PHYSICS    1  3    40   800   712   88   89  160   73   73  9.7   82   73 12-27
  1483. PNWTECH    4  3    40   800   719   81   90  160   81   81  8.8   90   81 01-01
  1484. PURSUIT    2  3    40   800   716   84   90  160  101  101  7.0  112  101 02-07
  1485. QUIKBAS    3  3    40   800   718   82   90  160   99   99  7.2  110   73 01-20
  1486. SCIENCE    3  3    40   800   715   85   89  160   67   67 10.6   75   64 01-19
  1487. SPORTS     6  3    40   800   717   83   90  160  108  108  6.6  120   85 01-12
  1488. TECH       2  3     5   800   717   83   90  160   75   75  9.5   83   28 01-21
  1489. TMPLANG    2  3    40   800    63  737    8  160   13   11  5.3  150   13 01-20
  1490. VIETVET    2  3    40   800   715   85   89  160   72   72  9.9   80   61 01-21
  1491. WARNING    1  3    40   800   718   82   90  160  105  105  6.8  117  105 07-20
  1492. RBBS       7  3    40   800   717   83   90  160   90   90  7.9  100   90 12-26
  1493. MSGTOSS    1  3    40   800   700  100   88  160   87   87  8.0   99   87 12-02
  1494. ---------------------------------------------------------------------- --------
  1495. Totals:  There are 2645 messages in 29 areas averaging 7.3 records per message.
  1496.          The 2.9 Mb allocated should hold 3458 total messages.
  1497.          There are 4404 unused records out of 23608 allocated.
  1498.  
  1499. NOTE: Unlike the /TEST command line switch,  /STAT will not pause every
  1500. 23 lines for viewing.  You can re-direct its output to a disk file.
  1501.  
  1502. Most  of  this data is derived from the message base  'checkpoint'  re-
  1503. cord(s).  Here is a summary of columns:
  1504.  
  1505. Conf Name - Name of the RBBS message base minus M.DEF
  1506. Num User  - Number of users in the conference
  1507. # N(odes) - Number of Node records
  1508. Sec Level - Security Level of conference (8224 = none)
  1509. Num Recs  - Actual number of 128-byte Records
  1510. Recs Used - Number of Records being occupied by messages
  1511. Recs Free - Number of Records Free (able to store messages)
  1512. Pct Full  - Percentage (%) of total records that contain messages
  1513.  
  1514.                                   Page - 23
  1515.  
  1516.  
  1517.  
  1518.  
  1519.  
  1520.                       MSGTOSS 2.0 Command Line Switches
  1521.  
  1522. Max Msgs  - What 'Max-Messages' is set to for this conference
  1523. Last Msg  - Number of the Last Message in the conference
  1524. Est Msg   - Number of estimated messages in message base
  1525. Msg Size  - Average size (in records) of the messages
  1526. Est Cap   - Estimated number of messages (based on average size)
  1527. HWM Msg   - The LAST message that was SCANNED
  1528. First Msg - Date of the First message
  1529.  
  1530. NOTE: This  can  be  directed  to  the printer or to  a  file  via  DOS
  1531.       redirection principles.
  1532.  
  1533. /STAT SWITCHES
  1534. --------------
  1535.  
  1536.     /STAT
  1537.     ------
  1538.     See information above.
  1539.     ------------------------------------------------------------------
  1540.  
  1541.     /COUNT  (COMMON)
  1542.     ------
  1543.     Physically count each RBBS message.  See page 10 for more details.
  1544.     ------------------------------------------------------------------
  1545.  
  1546.     /CFG:File.Ext   (COMMON)
  1547.     ------
  1548.     Use alternate MSGTOSS.CFG file.  See page 7 for more details.
  1549.     ------------------------------------------------------------------
  1550.  
  1551.     /BBS:File.Ext   (COMMON)
  1552.     ------
  1553.     Use alternate MSGTOSS.BBS file.  See page 7 for more details.
  1554.     ------------------------------------------------------------------
  1555.  
  1556.     /LOCK   (COMMON)
  1557.     ------
  1558.     Invoke multi-tasking/network support.  See page 8 for more details.
  1559.     ------------------------------------------------------------------
  1560.  
  1561.     /FIX    (COMMON)
  1562.     ------
  1563.     Auto-repair RBBS M.DEF(s) via FIXMSG.  See page 8 for more details.
  1564.     ------------------------------------------------------------------
  1565.  
  1566.     /FIXC   (COMMON)
  1567.     ------
  1568.     Auto-repair RBBS M.DEF(s) via FIXMSG.  See page 8 for more details.
  1569.     ------------------------------------------------------------------
  1570. ----------------------------------------------------------------------
  1571.  
  1572.  
  1573.  
  1574.  
  1575.  
  1576.  
  1577.  
  1578.  
  1579.  
  1580.                                   Page - 24
  1581.  
  1582.  
  1583.  
  1584.  
  1585.  
  1586.                       MSGTOSS 2.0 Command Line Switches
  1587.  
  1588.  
  1589. Test MsgToss Setup Configuration - /TEST
  1590. ----------------------------------------
  1591.  
  1592.  
  1593. The /TEST command line is used to test the MSGTOSS configuration.  This
  1594. checks  such  things as whether message and user files  exist,  testing
  1595. file handles (FILES=XXX entry in CONFIG.SYS),  fido directories, length
  1596. of  Origin line,  whether MSGTOSS is seeing all of the net/nodes in the
  1597. MSGTOSS.BBS file, and other tests to make sure MSGTOSS should work ok.
  1598.  
  1599. If MSGTOSS finds anything wrong, it will loudly complain, prompting you
  1600. to fix the problem.  More likely than not, it will probably be directo-
  1601. ry/file that does not exist.
  1602.  
  1603. At  the end of all of the testing,  MSGTOSS will essentially execute  a
  1604. /STAT function for more information.
  1605.  
  1606. Use  of this command line is absolutely essential during the setup  and
  1607. installation  of MSGTOSS for the first time,  and when problems are en-
  1608. countered at a later date.  It is recommended to execute:
  1609.  
  1610.     MSGTOSS /TEST /COUNT /FIX  ... other  switches
  1611.  
  1612. During the setup of MSGTOSS.   If MSGTOSS detects broken message chains
  1613. during this test (using /COUNT & /FIX),  MSGTOSS will attempt to fix it
  1614. via  FIXMSG (Version 1.4,  Mike Zakharoff,  available as FIXMSG14.xxx).
  1615. FIXMSG is required to be in the DOS path for this to work properly.
  1616.  
  1617.     Example:
  1618.  
  1619.     Initializing - MSGTOSS.CFG
  1620.     Initializing - No File Locking Active
  1621.     Initializing - MSGTOSS.BBS 
  1622.     Unique NET/NODE Index: 1  - 1:138/145@fidonet
  1623.     Unique Nodes Detected - 1  Minimum FILES=XX is 12 
  1624.     Max nodes for single area is 1 
  1625.  
  1626.     Default Origin line:
  1627.      * Origin: Msgtoss Support System - Sumner WA (206)862-4874 (Address)
  1628.  
  1629.     Press any key for file handle test
  1630.     Opening test file 1 
  1631.     Opening test file 2 
  1632.     Opening test file 3 
  1633.     Opening test file 4 
  1634.     Opening test file 5 
  1635.     Opening test file 6 
  1636.     Opening test file 7 
  1637.     Any key to for statistics (will perfom a /STAT display)
  1638.  
  1639. During the /STAT display, MSGTOSS will pause every 23 lines allowing you to
  1640. view  the message bases.   In addition,  if any of your MSGTOSS.BBS REC:xxx
  1641. keywords don't match the actual size of the message bases, MSGTOSS will re-
  1642. port to you (in bright white on red) the fact that this error exists.   The
  1643. error would look similar to this:
  1644.  
  1645.  
  1646.                                   Page - 25
  1647.  
  1648.  
  1649.  
  1650.  
  1651.  
  1652.                       MSGTOSS 2.0 Command Line Switches
  1653.  
  1654.  
  1655. RBBS       7  3    40   800   717   83   90  160   90   90  7.9  100  RECS:500
  1656.                                                                       ^^^^^^^^^
  1657.                                                                       White/Red
  1658.  
  1659. In  this case,  MSGTOSS is complaining that the actual size of the  message
  1660. base is 800, but your RECS:xxx value is set to 500.  If you get this error,
  1661. fix  the  appropriate  RECS:xxx keyword for these message  bases.   If  the
  1662. RECS:xxxx  value is correct (what you really want it to be),  then you  can
  1663. execute the /SIZE-UP command line switch so MSGTOSS can re-size the message
  1664. bases (see /SIZE & /SIZE-UP (this document).
  1665.  
  1666.  
  1667. NOTE: All  of  this  information can be re-directed to a  DOS  file  or
  1668.       printer via DOS re-direction principles.
  1669.  
  1670.     /TEST
  1671.     ------
  1672.     Perform a system installation test for MSGTOSS.   Report any set-up
  1673.     errors  that would certainly cause headaches at a later time.   See
  1674.     text above for more detail.
  1675.  
  1676.     NOTE: Absolutely essential during system installation
  1677.     ------------------------------------------------------------------
  1678.  
  1679.     /COUNT   (COMMON)
  1680.     ------
  1681.     Physically count each RBBS message.  See page 10 for more details.
  1682.     ------------------------------------------------------------------
  1683.  
  1684.     /CFG:File.Ext   (COMMON)
  1685.     ------
  1686.     Use alternate MSGTOSS.CFG file.  See page 7 for more details.
  1687.     ------------------------------------------------------------------
  1688.  
  1689.     /BBS:File.Ext   (COMMON)
  1690.     ------
  1691.     Use alternate MSGTOSS.BBS file.  See page 7 for more details.
  1692.     ------------------------------------------------------------------
  1693.  
  1694.     /LOCK   (COMMON)
  1695.     ------
  1696.     Invoke multi-tasking/network support.  See page 8 for more details.
  1697.     ------------------------------------------------------------------
  1698.  
  1699.     /FIX    (COMMON)
  1700.     ------
  1701.     Auto-repair RBBS M.DEF(s) via FIXMSG.  See page 8 for more details.
  1702.     ------------------------------------------------------------------
  1703.  
  1704.     /FIXC   (COMMON)
  1705.     ------
  1706.     Auto-repair RBBS M.DEF(s) via FIXMSG.  See page 8 for more details.
  1707.     ------------------------------------------------------------------
  1708.  
  1709. ----------------------------------------------------------------------
  1710.  
  1711.  
  1712.                                   Page - 26
  1713.  
  1714.  
  1715.  
  1716.  
  1717.  
  1718.                       MSGTOSS 2.0 Command Line Switches
  1719.  
  1720.  
  1721. Wait for users, create MSGWAIT.BAT file - /WAIT
  1722. -----------------------------------------------
  1723.  
  1724.  
  1725.     /WAIT
  1726.     ------
  1727.     The  /WAIT command line switch will monitor the 'node  records'  in
  1728.     the  main RBBS main message base to determine whether all users are
  1729.     off-line.  If  all users are off-line,  then MSGTOSS will create  a
  1730.     file  called MSGWAIT.BAT which can be tested for existence in  your
  1731.     batch file, example:
  1732.  
  1733.     MSGTOSS /WAIT
  1734.     If Exist MSGWAIT.BAT Goto SAFE2TOSS
  1735.     Goto CANTTOSS
  1736.  
  1737.     If the wait was unsuccessful, then no MSGWAIT.BAT file will be cre-
  1738.     ated.
  1739.  
  1740.     The  sysop can (DURING the waiting process),  press [C]ontinue  and
  1741.     MSGTOSS will continue to process, as if all users are now off-line,
  1742.     creating MSGWAIT.BAT.  This functions as an override.
  1743.  
  1744.     NOTE: This  function  is included in MSGTOSS 2.0 for  compatibility
  1745.           purposes  only with MSGTOSS 1.3.   It essentially is obsolete
  1746.           via  the  multi-tasking/network support provided  in  MSGTOSS
  1747.           2.0+.
  1748.     ------------------------------------------------------------------
  1749.  
  1750.     /CFG:File.Ext   (COMMON)
  1751.     ------
  1752.     Use alternate MSGTOSS.CFG file.  See page 7 for more details.
  1753.     ------------------------------------------------------------------
  1754.  
  1755.     /BBS:File.Ext   (COMMON)
  1756.     ------
  1757.     Use alternate MSGTOSS.BBS file.  See page 7 for more details.
  1758.     ------------------------------------------------------------------
  1759.  
  1760.     /LOCK   (COMMON)
  1761.     ------
  1762.     Invoke multi-tasking/network support.  See page 8 for more details.
  1763.     ------------------------------------------------------------------
  1764.  
  1765. ----------------------------------------------------------------------
  1766.  
  1767.  
  1768.  
  1769.  
  1770.  
  1771.  
  1772.  
  1773.  
  1774.  
  1775.  
  1776.  
  1777.  
  1778.                                   Page - 27
  1779.  
  1780.  
  1781.  
  1782.  
  1783.  
  1784.                       MSGTOSS 2.0 Command Line Switches
  1785.  
  1786.  
  1787. Globally execute xxx for all msg bases - /GLOB:xxx
  1788. --------------------------------------------------
  1789.  
  1790.  
  1791.     /GLOB:xxx
  1792.     ---------
  1793.     The  /GLOB:  switches  are  guaranteed to make  life  easier.   The
  1794.     switches are /GLOB:xxx and /GBAT.
  1795.  
  1796.     These two switches allow GLOBAL maintenance to occur on either RBBS
  1797.     message users, & welcome files as well as Fido sub-directories.
  1798.  
  1799.     Example:
  1800.  
  1801.     MSGTOSS /GLOB:COPY C:\RBBS\BLANKM.DEF [MSGFILE] <rtn>
  1802.  
  1803.     Will  GLOBALLY  copy  blankm.def  over all message  bases  in  your
  1804.     MSGTOSS.BBS file (deadly, but possible).
  1805.  
  1806.     MSGTOSS /GLOB:COPY C:\RBBS\BLANKM.DEF [MSGFILE] /GBAT <rtn>
  1807.                                                     ^^^^^
  1808.     Notice the /GBAT appended...  This will do the same, EXCEPT it will
  1809.     instead  create  a file called MSGLOBAL.BAT that will  contain  the
  1810.     commands that would have been used to do the first one..
  1811.  
  1812.     MSGTOSS /GLOB:DEL [FIDOSUB]\*.* <rtn>
  1813.  
  1814.     Will delete every #.MSG file in your MSGTOSS.BBS (not recommended).
  1815.  
  1816.     How about...
  1817.  
  1818.     MSGTOSS /GLOB:FIXMSG [MSGFILE] <rtn>...
  1819.  
  1820.     Will globally fix all message bases in one swipe...
  1821.  
  1822.     MSGTOSS /GLOB:MSGRENUM /MSG:[MSGFILE] /USR:[USRFILE] <rtn>
  1823.  
  1824.     Is another possibility....
  1825.  
  1826.     Again,  adding  /GBAT will not actually execute,  but instead  will
  1827.     create MSGLOBAL.BAT...  Allows editing/verification before actually
  1828.     executing the command.
  1829.  
  1830.     NOTE: [FIDOSUB] does not have a trailing backslash. 
  1831.  
  1832.     You  can also set up multiple MSGTOSS 'Meta-Commands'  using /GLOB:
  1833.     to perform a variety of message base maintenance tasks.   Here's an
  1834.     example:
  1835.  
  1836.     FKILL /GLOB:ECHO Y|DEL [FIDOSUB]\*.*
  1837.  
  1838.     Where the '|'  character (not allowed at the DOS prompt) can be put
  1839.     in  as  a Meta-Command and will delete the contents of ALL of  your
  1840.     Fido subs.  
  1841.     
  1842.     Valid parameters are [MSGFILE] [USRFILE] [WELFILE] [AREA] [FIDOSUB]
  1843.  
  1844.                                   Page - 28
  1845.  
  1846.  
  1847.  
  1848.  
  1849.  
  1850.                       MSGTOSS 2.0 Command Line Switches
  1851.  
  1852.  
  1853.     NOTE: Can't  mix  RBBS  stuff with FIDO stuff;  [AREA]  is  mixable
  1854.           though.
  1855.  
  1856.     If you get confused,  execute MSGTOSS <rtn>,  and it will provide a
  1857.     reminder of commands.
  1858.     ------------------------------------------------------------------
  1859.  
  1860.     /GBAT
  1861.     ------
  1862.     Create MSGLOBAL.BAT for /GLOB:xxx cmds.  See /GLOB:xxxx section.
  1863.  
  1864.     NOTE: /GBAT must be the last entry of the /GLOB: command.
  1865.     ------------------------------------------------------------------
  1866.  
  1867.     /CFG:File.Ext   (COMMON)
  1868.     ------
  1869.     Use alternate MSGTOSS.CFG file.  See page 7 for more details.
  1870.     ------------------------------------------------------------------
  1871.  
  1872.     /BBS:File.Ext   (COMMON)
  1873.     ------
  1874.     Use alternate MSGTOSS.BBS file.  See page 7 for more details.
  1875.     ------------------------------------------------------------------
  1876.  
  1877.     /LOCK   (COMMON)
  1878.     ------
  1879.     Invoke multi-tasking/network support.  See page 8 for more details.
  1880.     ------------------------------------------------------------------
  1881.  
  1882. ----------------------------------------------------------------------
  1883.  
  1884.  
  1885.  
  1886.  
  1887.  
  1888.  
  1889.  
  1890.  
  1891.  
  1892.  
  1893.  
  1894.  
  1895.  
  1896.  
  1897.  
  1898.  
  1899.  
  1900.  
  1901.  
  1902.  
  1903.  
  1904.  
  1905.  
  1906.  
  1907.  
  1908.  
  1909.  
  1910.                                   Page - 29
  1911.  
  1912.  
  1913.  
  1914.  
  1915.  
  1916.                       MSGTOSS 2.0 Command Line Switches
  1917.  
  1918.  
  1919. Recompile the node list (MSGTOSS.NOD) - /NLST
  1920. ---------------------------------------------
  1921.  
  1922.  
  1923.     /NLST
  1924.     ------
  1925.     This  command  line switch executes MSGNLST.EXE,  which is used  to
  1926.     compile the MSGTOSS proprietary nodelist called MSGTOSS.NOD.   This
  1927.     is used in conjunction with the DOMAIN------> parameters.
  1928.  
  1929.     The  MSGTOSS.NOD  file contains nodelist information  that  MSGTOSS
  1930.     uses to identify the Zone:Net/Node@Domain of *.PKT files.
  1931.  
  1932.     -----------------------> I M P O R T A N T ! <---------------------
  1933.  
  1934.     The command:    MSGTOSS /NLST 
  1935.  
  1936.     Must  be  entered as part of your nodelist processing  batch  file.
  1937.     After you have merged new NODEDIFFs, you need to:
  1938.  
  1939.        1) Change drive/directory(s) back to the MSGTOSS directory
  1940.        2) Execute MSGTOSS /NLST
  1941.        3) Return back to finish other nodelist processing
  1942.  
  1943.     This will create the MSGTOSS.NOD file in the MSGTOSS directory, us-
  1944.     ing  the MSGTOSS.CFG to obtain the directories where the  nodelists
  1945.     are via the multiple DOMAIN------> entries.
  1946.  
  1947.     For  more information on this switch and how it interacts with  the
  1948.     tossing   system,   see  MSGCFG.DOC,   section  DOMAIN----->,   and
  1949.     MSGTOSS.DOC,   INSTALLATION   section  'Create  MSGTOSS.NOD   using
  1950.     MSGNLST.EXE'.
  1951.     ------------------------------------------------------------------
  1952.  
  1953. ----------------------------------------------------------------------
  1954.  
  1955.  
  1956.  
  1957.  
  1958.  
  1959.  
  1960.  
  1961.  
  1962.  
  1963.  
  1964.  
  1965.  
  1966.  
  1967.  
  1968.  
  1969.  
  1970.  
  1971.  
  1972.  
  1973.  
  1974.  
  1975.  
  1976.                                   Page - 30
  1977.  
  1978.  
  1979.  
  1980.  
  1981.  
  1982.                       MSGTOSS 2.0 Command Line Switches
  1983.  
  1984.  
  1985. Execute MSGEID.EXE - EID Database Maint - /EID
  1986. ----------------------------------------------
  1987.  
  1988.  
  1989.     /EID
  1990.     ----
  1991.     This  command  line switch executes MSGEID.EXE,  which is  used  to
  1992.     maintain  the MSGTOSS.EID database that contains all of the EID and
  1993.     MSGEID codes.
  1994.  
  1995.     The  MSGTOSS.EID databse is created when the BBS keyword CDUP:1  is
  1996.     present  in the MSGTOSS.BBS file.   MSGEID.EXE allows the user  the
  1997.     ability to view/edit the EID database.
  1998.  
  1999.     Syntax:
  2000.      
  2001.     MSGTOSS /EID [file] <rtn>  -or-  MSGEID.EXE  [file] <rtn>
  2002.  
  2003.         [file] = alternate MsgToss CONFIG file (blank = MSGTOSS.CFG)
  2004.  
  2005.     Produces a similar display:
  2006.     ------------------------------------------------------------------
  2007.     MsgToss 2.0 02/07/92 (c)1992 Mike Zakharoff Warren Muldrow  MSGEID
  2008.  
  2009.     Actual - MSGTOSS.EID  MAXAREAS: 52  DUPSIZE: 224  (actual)
  2010.     Config - MSGTOSS.CFG  MAXAREAS: 52  DUPSIZE: 208
  2011.  
  2012.                1) - Display MSGTOSS.EID index
  2013.                2) - Make MSGTOSS.CFG parameters match
  2014.                3) - Pack (remove dead space)
  2015.                4) - Clear  a particular  AREA
  2016.                5) - Clear  all inactive  AREAs
  2017.                6) - Clear  all NODE:x    AREAs
  2018.                7) - Change all NODE:x to NODE:y
  2019.                8) - Display EID data for AREA
  2020.                9) - Change MAXAREAS & DUPSIZE
  2021.                H) - Help on the above
  2022.     ------------------------------------------------------------------
  2023.     MSGEID.EXE  will (without any command line parameters) will  assume
  2024.     that MSGTOSS.CFG is in the default directory and obtain the name of
  2025.     the DUPFILE, MAXAREAS, and DUPSIZE from it.
  2026.  
  2027.     NOTE: The  MAXAREAS  &  DUPSIZE parameters entered  in  MSGTOSS.CFG
  2028.           serve as "approximate"  values.  MSGTOSS, when it creates the
  2029.           EID  database,  will round these values up to accomodate  the
  2030.           internal structure of the EID database.   The "(actual)" val-
  2031.           ues  displayed (as shown above) reflects the true  capacities
  2032.           of the EID database.
  2033.  
  2034.  
  2035.     Display MSGTOSS.EID index
  2036.     -------------------------
  2037.     Displays  MSGTOSS.EID  index that contains all of the  AREA(s)  and
  2038.     their associated NODE entries.  This is helpful when there is doubt
  2039.     as  to  their existance or status.   AREA(s) preceeded with  a  '-'
  2040.     indicate an INACTIVE or BLANK area.
  2041.  
  2042.                                   Page - 31
  2043.  
  2044.  
  2045.  
  2046.  
  2047.  
  2048.                       MSGTOSS 2.0 Command Line Switches
  2049.  
  2050.  
  2051.  
  2052.     Make MSGTOSS.CFG parameters match
  2053.     ---------------------------------
  2054.     Will  PHYSICALLY modify your MSGTOSS.CFG file to make sure that the
  2055.     MAXAREAS  and DUPSIZE properly match the EID database.   After  up-
  2056.     date,  will  ask if you if you have another (alternate) config file
  2057.     to update.
  2058.  
  2059.  
  2060.     Pack (remove dead space)
  2061.     ------------------------
  2062.     Will  reduce the size of the EID database to its smallest  possible
  2063.     size,  keeping the original MAXAREAS & DUPSIZE parmeters.  You have
  2064.     the option to keep or purge INACTIVE areas.
  2065.  
  2066.  
  2067.     Clear  a particular  AREA
  2068.     -------------------------
  2069.     Will  clear a SINGLE area from the EID database,  along with all of
  2070.     its associated data (EID & MSGID codes).
  2071.  
  2072.  
  2073.     Clear all inactive AREAs
  2074.     ------------------------
  2075.     Will clear all INACTIVE area from the EID database,  along with all
  2076.     of  its  associated data (EID & MSGID codes).   INACTIVE areas  are
  2077.     preceeded by a '-' character.
  2078.  
  2079.     Clear all NODE:x AREAs
  2080.     ----------------------
  2081.     Will  GLOBALLY  clear all AREA(s) with a particular  NODE:x  entry.
  2082.     Usefull  for  clearing AREAS created by changing the order  of  the
  2083.     NODE:x entries in in either the MSGTOSS.BBS or MSGTOSS.CFG file.
  2084.  
  2085.  
  2086.     Change all NODE:x to NODE:y
  2087.     ---------------------------
  2088.     Will  GLOBALLY  change all NODE:x entries to another NODE:y  entry.
  2089.     Usefull  when re-organizing NODE:x orders in either the MSGTOSS.BBS
  2090.     or MSGTOSS.CFG file(s).
  2091.  
  2092.  
  2093.     Display EID data for AREA
  2094.     -------------------------
  2095.     Displays  the actual MSGID:  or EID:  codes (in HEX format) entered
  2096.     for a area.  Useful for verifying existance of a certain code.
  2097.  
  2098.  
  2099.     Change MAXAREAS & DUPSIZE
  2100.     -------------------------
  2101.     Allows you to change the MAXAREAS and/or DUPSIZE of an existing EID
  2102.     database file.   Prior to MsgToss 2.0,  you would have to erase it.
  2103.     When re-sizing, will keep all existing EID codes.  MAXAREAS is lim-
  2104.     ited to 1000 or less.
  2105.     ------------------------------------------------------------------
  2106. ----------------------------------------------------------------------
  2107.  
  2108.                                   Page - 32
  2109.  
  2110.  
  2111.  
  2112.  
  2113.  
  2114.                       MSGTOSS 2.0 Command Line Switches
  2115.  
  2116.  
  2117. MSGTOSS.CMD Meta-Commands - (no slashes)
  2118. ----------------------------------------
  2119.  
  2120.     MSGTOSS Meta-Commands
  2121.     ---------------------
  2122.     MSGTOSS  can  now be configured to execute  user-defined  Meta-Com-
  2123.     mands.  For example...
  2124.  
  2125.     MSGTOSS TOSS <rtn>
  2126.  
  2127.     Could now execute /TOSS /PREP /FIXC, etc...  in one clean sweep
  2128.  
  2129.     The  file that contains the Meta-Commands is called  MSGTOSS.CMD...
  2130.     here is a sample:
  2131.  
  2132.     TOSS1 /TOSS/DDA/DLOG/FIXC/KNET/KUNK/LOCK/NSTOP/PREX/WDIR/DKP
  2133.     TOSS2 /TOSS/DDA/DLOG/FIXC/LOCK/NSTOP/PREX/WDIR/DKP
  2134.     FIX   /GLOB:FIXMSG [MSGFILE] /NET
  2135.     RNUM  /GLOB:MSGRENUM /MSG:[MSGFILE] /USR:[USRFILE] /NET
  2136.  
  2137.     These are the configurable Meta-Commands.   As you can see, execut-
  2138.     ing..
  2139.  
  2140.     MSGTOSS FIX <rtn> will automatically execute the /GLOB....  command
  2141.     MSGTOSS CMD <rtn> will do a list of the MSGTOSS.CMD file for refer-
  2142.     ence.
  2143.  
  2144.     The original purpose of this is to overcome extremely long commands
  2145.     at the DOS prompt, but it turned out to be an asset.  The Meta-Com-
  2146.     mand  can be named anything and the switches can contain any  valid
  2147.     MSGTOSS switch set.
  2148.  
  2149.     If you have two Meta-Commands called 'TOSS' and 'NODES' you can en-
  2150.     ter  'MSGTOSS TOSS NODES <rtn>'  where 'TOSS'  and 'NODES'  are the
  2151.     Meta-Commands  you have defined or both types of  operations.   Its
  2152.     just  like you executed both command lines at the DOS  prompt,  and
  2153.     are not limited by DOS's command line limit.
  2154.  
  2155.     SUMMARY
  2156.     -------
  2157.     MsgToss Meta-Commands allow you to configure one (or more) single
  2158.     keywords to mean any combination of MsgToss switches.
  2159.  
  2160.        MSGTOSS CMD <rtn> lists all MSGTOSS.CMD Meta-Commands.
  2161.        MSGTOSS xxx <rtn> Meta-Command (xxx) execution syntax.
  2162.        MSGTOSS xxx xxx <rtn> multiple Meta-Commands are allowed
  2163.        MSGTOSS xxx /xx <rtn> may follow with normal commands
  2164.  
  2165.     MsgToss  Meta-Commands allow you to configure one (or more)  single
  2166.     Keywords to mean any combination of MsgToss switches (see docs).
  2167.     ------------------------------------------------------------------
  2168.  
  2169. ----------------------------------------------------------------------
  2170.  
  2171.  
  2172.  
  2173.  
  2174.                                   Page - 33
  2175.  
  2176.  
  2177.  
  2178.  
  2179.  
  2180.                       MSGTOSS 2.0 Command Line Switches
  2181.  
  2182.  
  2183. MSGTOSS ErrorLevel Semaphore File Codes - Errorlevels
  2184. -----------------------------------------------------
  2185.  
  2186.  
  2187.     ERRORLEVELS
  2188.     -----------
  2189.     MSGTOSS  supports an errorlevel kludge to allow creative batch file
  2190.     operations in a variety of situations.   This is accomplished via a
  2191.     semaphore file, and does NOT create a TRUE DOS errorlevel.  
  2192.  
  2193.     NOTE: It should be noted that prior to DOS 5.0, the beta version of
  2194.           MSGTOSS  did  support  true  errorlevels.   Because  of  this
  2195.           conflict,  this  was  disabled  in the MSGTOSS  2.0  release.
  2196.           Version 2.1 will support true errorlevels.
  2197.  
  2198.     Here is a summary of the errorlevels supported:
  2199.  
  2200.        1) Configuration Error ---------------------->255 Errorlevels
  2201.        2) Command Line Error ----------------------->254
  2202.        3) Insufficient Disk Space ------------------>253
  2203.        4) File Open Failure ------------------------>252
  2204.        5) Trapped a FATAL error (Msgtoss Aborted) -->251
  2205.        6) Corrupt Message File --------------------->250
  2206.        7) Message base expansion took place -------->120
  2207.        8) ConfLock Timer expired ------------------->110
  2208.        9) Not enough packets (or none) to Toss ----->100
  2209.       10) Normal end of program -------------------->  0
  2210.  
  2211.     MSGTOSS  will create a zero-byte semaphore file called MSGERLVL.xxx
  2212.     where xxx is the errorlevel (1+) with leading zeros.
  2213.  
  2214.     NOTE: MSGTOSS  will  delete any existing MSGERLVL.xxx  files  every
  2215.           time it  is  executed.   Upon  an exit,  only  one  (if  any)
  2216.           semaphore file will be present in the MSGTOSS directory.
  2217.  
  2218.     To capture errorlevels,  use your batch file to detect the errorle-
  2219.     vel(s)   via   the   MSGTOSS  errorlevel   semaphore   files   like
  2220.     MSGERLVL.001, 002, etc.
  2221.  
  2222.     Example:
  2223.     
  2224.     :TOSS
  2225.        MSGTOSS /TOSS /PREP /LOCK
  2226.        If Exist MSGERLVL.253 Goto DISKFULL
  2227.        Goto START
  2228.  
  2229.     :DISKFULL
  2230.        ECHO Disk Full!!!! >LPT1
  2231.        Goto START
  2232.  
  2233. ----------------------------------------------------------------------
  2234.  
  2235.  
  2236.  
  2237.  
  2238.  
  2239.  
  2240.                                   Page - 34
  2241.  
  2242.  
  2243.  
  2244.  
  2245.